home *** CD-ROM | disk | FTP | other *** search
/ Aminet 19 / Aminet 19 (1997)(GTI - Schatztruhe)[!][Jun 1997].iso / Aminet / comm / cnet / gu40pack.lha / gu40pack / OFFSET_Scanner.README! < prev   
Text File  |  1997-03-21  |  17KB  |  335 lines
  1. ============================================================================
  2.        OFFSET Value Scanner, v2.10 Written by Dotoran of Frontiers!
  3. ============================================================================
  4.  
  5. What Is It?
  6. ~~~~~~~~~~~
  7.     This program will let you peek behind the scenes of CNet Amiga by giving
  8. you the ability to see what is stored in various memory locations, aka
  9. OFFSET locations.
  10.  
  11.     It also has many powerful functions built-in that will make searching out
  12. an "unknown" GETUSER quite easy, or for TESTING a GETUSER to see if it will
  13. return the value you are looking for.
  14.  
  15. How Do I Install It?
  16. ~~~~~~~~~~~~~~~~~~~~
  17. 1: Place the "OFFSET_Scanner" and "OFFSET_BookMarks" files somewhere in your
  18.    system. I chose to keep them both in the included "GU40Pack/" directory,
  19.    which I then stored in my TEXTS: assigned path(this is what I call my
  20.    gfiles area in CNet, v4.xx). The "BookMarks" file MUST be stored in the
  21.    SAME location as the OFFSET_Scanner in order for it to be found.
  22.  
  23. 2: You can ADD the "OFFSET_Scanner" into your DOORS section as a SysOp Only
  24.    ARexx File, mainly because this file won't be of much use to regular users
  25.    on your system. It doesn't do anything HARMFUL to the data, but DOES have
  26.    the ability to show user passwords and other vital info on the screen. It
  27.    is for this reason, you will want to keep close tabs as to WHO can use
  28.    this file.
  29.  
  30. 3: Add the following line to the bottom of Menu # 1, Maintenance Menu
  31.    in your BBSMENU file:
  32.  
  33.     OFFSET scanner      | {#0<path>OFFSET_Scanner}
  34.                           |
  35.                           `--> A Control-Q Character
  36.  
  37.    Replace <path> above with the location you chose to store the file in
  38.    Step # 1 above. This will create a command "OFFSET" that you can type 
  39.    from anywhere on your system to load and run the Scanner.
  40.  
  41. 4: Save your bbsmenu file, then reload it by clicking once on your Control
  42.    Panel window, then pressing RAMIGA-T and you'll be all set!
  43.  
  44. How Do I Use The Scanner?
  45. ~~~~~~~~~~~~~~~~~~~~~~~~~
  46.     After you start the program, you will be asked four questions. The first
  47. question asks you for the value to START scanning from. This can be any valid
  48. GETUSER value:
  49.  
  50.           1 thru 102     - Predefined SHORT GetUser values.
  51.     1x00000 thru 1x15490 - Long Offsets in the PortData structure.
  52.     2x00000 thru 2x28220 - Long Offsets in the MainPort structure.
  53.     3x00000 thru 3x00573 - Long Offsets in the PortDataExtension struct.
  54.     4x00000 thru 4x00992 - Long Offsets in the MainPortExtension struct.
  55.  
  56.     This question will default to the LAST GetUser value you were looking at 
  57. when you QUIT the program, or "1" if it's the first time you used the program, 
  58. if you press ENTER/RETURN without typing a specific value.
  59.  
  60.     The second question allows you to type the characters you wish to TEST
  61. for. The Scanner will STOP when it comes to a value that is either EQUAL TO
  62. or CONTAINS the TEST string. More on TESTING in a bit. This question will
  63. default to the text "XXX", which is very seldomly found.
  64.  
  65.     The third question asks you which ID Number you'd like to load into the
  66. CNet Scratch Buffer initially. The Scanner can also be used to read any values
  67. from within the Scratch Buffer too! This question will default to ID # 2, as
  68. it is assumed that ID # 1 will be the one using the Scanner the most, and you
  69. wouldn't want ID # 1 to reside in ALL the locations, as you would then not
  70. know which were regular locations and which were Scratch locations.
  71.  
  72.     The last question will simply ask you if you'd like to view the MENU of
  73. commands, before the first location is scanned. It defaults to NO for speed.
  74.  
  75.     I mainly wrote this program as a way of SEARCHING OUT certain characters
  76. and/or values found within CNet. That's where the TEST string comes in. By
  77. telling the program to search large ranges given a definate test string, one
  78. can simply let the computer do the work for you.
  79.  
  80.     When you first use the program, and answer the four initial questions,
  81. you will be shown the OFFSET value you specified, followed by the contents
  82. that are found within that location. (NOTE: The actual contents are what
  83. FOLLOW the colon. The colon after the OFFSET is supplied by the program.)
  84.  
  85.     Below this value, you will see "->" which is the work prompt for this
  86. program. Simply pressing RETURN at this prompt will display the next
  87. location in numerical order, so if you pressed RETURN four times for the
  88. initial questions and were shown location number 1, pressing RETURN here
  89. would show you location number 2, or "GETUSER 2", which is the user's
  90. PASSWORD.
  91.  
  92.     Try pressing one of the following characters at the "->" prompt:
  93.  
  94.                 /       ?       M       H
  95.  
  96.     All four do the same thing, they show you a help menu of the available
  97. work commands. Here's the menu that is shown to you:
  98.  
  99. ->D: DISPLAY This Many OffSets.         ->N: Specify NEW Offset(???????).
  100. ->V: New VARIABLE Type(??xxxxx).        ->O: New  OFFSET Digits(xx?????).
  101. ->T: Specify New TEST String.           ->E: ENTER Sleep Test Mode.
  102. ->+: Move List FORWARDS.                ->-: Move List BACKWARDS.
  103. ->U: Use GETUSER Command.               ->S: Use GETSCRATCH Command.
  104. ->P: PICK New GetScratch User.          ->J: Specify New JUMP Value.
  105. ->B: Set GetUser BOOKMARK(0-9).         ->F: FLIP to GetUser BookMark(0-9).
  106. ->L: LIST GetUser BookMarks.            ->C: CLEAR The Screen Now.
  107. ->H: This MENU(Also M / ?).             ->Q: Quit Scanning OffSets.
  108.  
  109.     And here is a description of each command found ON that Menu:
  110.  
  111. ->D: DISPLAY This Many OffSets.
  112.  
  113.     - Tells the Scanner how many OFFSET's to DISPLAY on the screen BEFORE
  114.       you see the work prompt again. When you first start the Scanner, the
  115.       DISPLAY value is set to "1". Try setting it to "20" or "23" to fill
  116.       the whole screen with a range of OFFSET values.
  117.  
  118. ->N: Specify NEW Offset(???????).
  119.  
  120.     - Will allow you to specify a NEW OFFSET value to start Scanning from.
  121.       In our initial example, we were working with the "short" values. Try
  122.       pressing "N" and typing in: 1300119 and pressing your RETURN key two
  123.       times. The user's street address should be displayed for the contents.
  124.  
  125. ->V: New VARIABLE Type(??xxxxx).
  126.  
  127.     - Will allow you to specify a New Variable TYPE & Structure location. In
  128.       other words, this command will allow you to specify a different two
  129.       FIRST digits, while keeping the last FIVE digits the same. For more
  130.       info on Variable Types & Structure Locations, see the "GU40_Intro".
  131.  
  132. ->O: New  OFFSET Digits(xx?????).
  133.  
  134.     - Will allow you to specify a New LOCATION Value. In other words, this
  135.       command allows you to modify the LAST FIVE digits, while keeping the
  136.       first TWO digits intact. For more information concerning LOCATION
  137.       values, see the "GU40_Intro".
  138.  
  139. ->T: Specify New TEST String.
  140.  
  141.     - Allows you to change the active TEST to search for. More on TESTING
  142.       in a second...
  143.  
  144. ->E: ENTER Sleep Test Mode.
  145.  
  146.     - When in "Sleep Mode", the program will continue to search for the TEST
  147.       string, but will NOT print the data down the screen, nor will it print
  148.       the actual data found in EACH location. Using "Sleep Mode" is a sub-
  149.       stantially faster way to search out your TEST string. You can ABORT
  150.       "Sleep Mode" by pressing any key, after which you'll be given the ->
  151.       prompt. If the TEST string is FOUND, you will be shown the locations
  152.       of the previous FIVE getusers, THEN the location the TEST string was
  153.       located in. Pressing "E" again will continue the test from the current
  154.       location.
  155.  
  156. ->+: Move List FORWARDS.
  157.  
  158.     - Tells the Scanner to Scan FORWARDS,  like this: 1, 2, 3, 4, 5, etc...
  159.  
  160.     - You may use the EQUALS Key to do the same thing, if that makes it any
  161.       easier for you.
  162.  
  163. ->-: Move List BACKWARDS.
  164.  
  165.     - Tells the Scanner to Scan BACKWARDS, like this: 5, 4, 3, 2, 1, etc...
  166.  
  167.     - If a JUMP Value is set higher than "1", scanning BACKWARDS will also
  168.       JUMP that many locations backwards. Remember, if you're looking for a
  169.       particular PATTERN in the values AND you are scanning BACKWARDS, you
  170.       will have to think about your PATTERN backwards. By this I mean if you
  171.       were looking for the ID# pattern talked about below in the "J" command,
  172.       you'd be looking for this pattern: 1 1 -1 -1  (for ID # 1, ID # 1,
  173.       Empty Port, Empty Port), but if you are Scanning BACKWARDS, you'd be
  174.       looking for this pattern: -1 -1 1 1. See?!?
  175.  
  176. ->U: Use GETUSER Command.
  177.  
  178.     - The Scanner defaults to displaying the values returned when used by
  179.       the GETUSER command. You'll see a lowercase "u" to the LEFT of each
  180.       OFFSET value alerting you to this fact. This command is used to return
  181.       to using the GETUSER command, IF you were using the GETSCRATCH command
  182.       talked about next...
  183.  
  184. ->S: Use GETSCRATCH Command.
  185.  
  186.     - By pressing "S", you can tell the Scanner to read the values using the
  187.       GETSCRATCH command, instead of the GETUSER command. This will allow you
  188.       to find the GETUSER values for selected Scratch Locations. You'll be
  189.       shown a lowercase "s" to the LEFT of the OFFSET value to alert you to
  190.       the fact you're using the GETSCRATCH command. Press "U" to switch back
  191.       to using the GETUSER command.
  192.  
  193. ->P: PICK New GetScratch User.
  194.  
  195.     - Pressing "P" will allow you to specify an alternate account to load
  196.       into the Scratch Buffer. This allows you to change your answer to the
  197.       third initial question that was asked upon entering this file.
  198.  
  199. ->J: Specify New JUMP Value.
  200.  
  201.     - Allows you to specify a JUMP value. By default, the Scanner doesn't
  202.       JUMP over ANY values. By this I mean if you were looking at value 1,
  203.       the next value you would see would be 2, then 3, then 4, etc. setting
  204.       the JUMP value to something other than 1 allows you to view every
  205.       N'th value. This comes in handy when viewing some of the "long" OFFSET
  206.       values, like "AGName", which fills thirty-two locations with one piece
  207.       of information. Try pressing "N" followed by this value: 2302058. This
  208.       is the location where the name of Access Group # 0 is stored. If you
  209.       take a look at the next couple of locations, you'll see that each
  210.       consecutive location contains one less character than the previous
  211.       location. Now, press "N", followed by 2302214, and you'll see the name
  212.       for Access Group # 1. Now press "N" and 2302058 to go back to group 0's
  213.       name. This time, press "J" and type the value "156" and press RETURN.
  214.       Type "D" and set it for "31", then press your RETURN key TWO times.
  215.       You should then see the NAMES for all 32 of your Access Groups!
  216.  
  217. ->B: Set GetUser BOOKMARK(0-9).
  218.  
  219.     - This version of the Scanner allows you to create up to TEN "BookMarks",
  220.       or GETUSER locations to REMEMBER. You can then do DIRECTLY to that
  221.       location using the "F" command, or list them using the "L" command. To
  222.       set a BookMark, you should have the GetUser Value you wish to remember
  223.       displayed on your screen, then press "B". At the B: prompt, type any
  224.       number from 0 thru 9 to store this location onto that key. All your
  225.       BookMarks will be SAVED when you QUIT the program, so that you can USE
  226.       them again the next time to use the Scanner.
  227.  
  228.     - NOTE: Since the Scanner also SAVES the LAST location you were looking
  229.             at, this could be considered an ELEVENTH BookMark. (Hint: Press
  230.             the | key(RIGHT of the "=" key) to move to this location!)
  231.  
  232. ->F: FLIP to GetUser BookMark(0-9).
  233.  
  234.     - FLIP allows you to go DIRECTLY to one of your defined BookMarks. Press
  235.       "F", followed by a number from 0 thru 9 to go DIRECTLY to that location.
  236.  
  237. ->L: LIST GetUser BookMarks.
  238.  
  239.     - Use the "L" command to LIST your defined BookMarks, possibly before
  240.       using the "F" command above, so as not to overwrite an existing book
  241.       mark you may have wanted to keep.
  242.  
  243. ->C: CLEAR The Screen Now.
  244.  
  245.     - Will clear the entire screen and print the LAST location you were
  246.       looking at at the top of the screen. This is sometimes useful when
  247.       working with the x6xxxxx's or the x3xxxxx's that may print garbled
  248.       characters all over the screen, which makes for TOUGH reading.
  249.  
  250. ->H: This MENU(Also M / ?).
  251.  
  252.     - One of the four keys that will redisplay this help menu.
  253.  
  254. ->Q: Quit Scanning OffSets.
  255.  
  256.     - Will tell the Scanner you wish to QUIT. You will have to press Q again
  257.       when you see the "Q to Quit:" prompt to actually QUIT the program, or
  258.       press RETURN again to reenter the work prompt "->".
  259.  
  260. ----------------------------------------------------------------------------
  261.     OK, now for a word on TESTING. Thus far, the TEST works in this way:
  262.  
  263. 1: The TEST will only stop if one of three things should occur:
  264.  
  265.     - An EXACT match is found.
  266.     - A string CONTAINING the Test string is found.
  267.     - The "DISPLAY" value has been reached.
  268.  
  269. 2: If a match IS found, the "D" value will be dropped to "10" if it's
  270.    set to a higher value. This was done so that you could view the next
  271.    couple locations and see if the pattern you may have been searching for
  272.    exists, or if you need to continue searching out the TEST string.
  273.  
  274.    If you're simply scanning through the locations and don't wish to TEST
  275.    for anything, use "XXX" as your TEST STRING. I haven't run across ANY
  276.    location that contains these three characters, so you SHOULD be safe
  277.    using them.
  278.  
  279.    If you think you've found the location you're looking for, DON'T bet on
  280.    it. Double check your findings by exiting the Scanner and changing the
  281.    current value of this variable, then reuse the Scanner and type the same
  282.    OFFSET value to see if it presents you with the NEW UPDATED contents.
  283.    MANY of the locations store similar data, so at first it might confuse
  284.    you.
  285.  
  286.    The YES/NO or ON/OFF variables are some of the most "FUN" to try and
  287.    search out, because you'll find MANY, MANY 0's and 1's in the different
  288.    locations. For a tip in searching for one of these, try searching for a
  289.    select pattern. For instance, the PRIVATE info concerns the user's Real
  290.    Name, their Address, their Birthdate, etc. If you were searching out just
  291.    ONE of these values, you could be at it for DAYS, but if you search out
  292.    the WHOLE string(5 in all), it'll make your work lots easier. Let's take
  293.    an example:
  294.  
  295.                 Private Name    -> No
  296.                 Private Age     -> Yes
  297.                 Private Address -> Yes
  298.                 Private VOICE   -> Yes
  299.                 Private DATA    -> No
  300.  
  301.    If these are the current values, you could make the following pattern,
  302.    given a "Yes" means a "1", and a "No" means a "0": 0 1 1 1 0
  303.  
  304.     Now that you know the PATTERN, all that's left to do is find the 5
  305.     locations where 1's and 0's occur in this order. Use the Scanner to set
  306.     the START OFFSET value to: 1100550. This location falls a bit before the
  307.     actual locations where the PRIVATE flags are really stored. Can you find
  308.     the right PATTERN? Jot down the location that contains the first "0" of
  309.     the pattern and compare that value to the value found in the GETUSER
  310.     list. Did you figure it out correctly? Kinda neat, huh? Lastly, try
  311.     changing one of the PRIVATE items to see if the pattern also changes. If
  312.     so, your double check worked and you can safely assume you've found the
  313.     OFFSET you've been looking for.
  314.  
  315.     The default values when first starting the Scanner are as follows:
  316.  
  317.             DISPLAY -> Every ONE Location
  318.             OFFSET  -> Number 1 (User's Handle)
  319.             TEST    -> XXX (Three Capital Letters)
  320.             JUMP    -> Every 1 (Normal Progression)
  321.             + / -   -> Initially Scans Forward
  322.  
  323.     Also, when you first enter the Scanner, the SCRATCH Buffer defaults to
  324. loading the personal information of the user who holds Account # 2 on your
  325. system. This was done so the numerous SCRATCH Buffer Variables held info
  326. that possibly differs from the ID # 1 account.
  327.  
  328.     That's all there is to actually USING the Scanner program. Please take
  329. the time to read some of the other TEXT files in this package to learn even
  330. MORE about the GETUSER's!
  331.                                                                   - Dotoran
  332. ============================================================================
  333.     Stuck On The Web? Visit my corner>  http://www.bluemoon.net/~dotoran
  334. ============================================================================
  335.